home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / ASMCODE.ZIP / ASMOD.DOC < prev    next >
Text File  |  1994-11-02  |  7KB  |  163 lines
  1. ┌───────────────────────────────────────────────────────────────────────────┐
  2. │                                                                           │
  3. │                                     The                                   │
  4. │                            AmoebaSoft MOD Player                          │
  5. │                                   for the                                 │
  6. │                              Gravis UltraSound                            │
  7. │                                                                           │
  8. └───────────────────────────────────────────────────────────────────────────┘
  9.  
  10.  
  11.  
  12. FILES IN THIS ARCHIVE:
  13. ----------------------
  14.  
  15. Release 0.90 of The AmoebaSoft MOD Player includes the following files:
  16.  
  17.   ASMOD.EXE - the MOD player itself
  18.   ASMOD.ASL - some resources that ASMOD.EXE must have
  19.   ASMOD.DOC - this file
  20.  
  21.   Plus (in the SOURCE directory):
  22.     GUSMOD.PAS  - MOD loading and GUS interface routines
  23.     GUSHEAP.PAS - GUS memory management routines
  24.     NEWCRT.PAS  - keyboard and timer routines
  25.     TYPES.PAS   - some global variables and error handler
  26.     GUSUTIL.ASM - assembly source for the MOD player
  27.     GUSUTIL.OBJ - the assembled version of GUSUTIL.ASM
  28.     KEY.ASM     - assembly source for new keyboard handler
  29.     KEY.OBJ     - the assembled version of KEY.ASM
  30.  
  31.     TESTMOD.PAS - a short program to make sure the MOD player works
  32.  
  33.   The source for compiling ASMOD.EXE has not been included.
  34.  
  35. PROGRAM REQUIREMENTS:
  36. ---------------------
  37.  
  38. To use  the  AmoebaSoft MOD  Player your  computer  must  meet the following
  39. criteria:
  40.  
  41.   386 or better processor
  42.   VGA compatible graphics card
  43.   Advanced Gravis UltraSound or UltraSound MAX (both with 256K or more RAM)
  44.   MS-DOS 3.1 or better
  45.  
  46.   Some large modules may play incorrectly or not at all on UltraSounds with
  47.   < 512K of memory.
  48.  
  49.   This software is designed to run on a 486DX/33Mhz or faster computer, so
  50.   slower machines may not be capable of reaching the default frame rates of
  51.   30 frames per second.  Of course, slower computers may work great, but it
  52.   hasn't been tested.
  53.  
  54.  
  55.  
  56. ABOUT THE PROGRAM:
  57. ------------------
  58.  
  59. The AmoebaSoft MOD Player for the Gravis UltraSound plays 4, 6 and 8 channel
  60. MOD files on computers  equiped with a Gravis UltraSound or UltraSound  MAX.
  61. Obviously, there  are already a LOT of MOD players  around that  support the
  62. UltraSound, and though this MOD player may have a few unique features, it is
  63. intended  mainly as a demonstration of AmoebaSoft's UltraSound Interface for
  64. Borland Pascal.
  65.  
  66. This is a BETA release of the MOD player, and therefore most MOD effects are
  67. not yet implemented.  Those which ARE implemented are listed below:
  68.  
  69.   Effect #   Effect Name
  70.   ────────┬─────────────────
  71.     0Bh   │  Position Jump
  72.     0Ch   │  Set Volume
  73.     0Dh   │  Pattern Break
  74.     0Fh   │  Set Speed
  75.  
  76. Though this is a small number of the  possible commands, they are by far the
  77. most frequently used, and you should find that ASMOD  plays about 95% of all
  78. MODs correctly.  The best way to find out is to try it yourself.
  79.  
  80. More effects will be implemented in the near future.
  81.  
  82.  
  83.  
  84. USING THE PROGRAM:
  85. ------------------
  86.  
  87. First of all, be sure that ASMOD.EXE and ASMOD.ASL are in the same directory.
  88. This can be your current directory or a directory in the path.
  89.  
  90. There are two basic methods to using ASMOD.  First, you can specify the name
  91. of a MOD on the command line when you run ASMOD.  For example:
  92.  
  93.   ASMOD ODYSSEY.MOD
  94.  
  95. will play  ODYSSEY.MOD if the  file exists in the current directory.  If the
  96. MOD file has an  End Jump Position of 127 ASMOD will exit  back to DOS after
  97. playing the last pattern in of the MOD.  Otherwise it will loop until a user
  98. exits the program with Alt-X.
  99.  
  100. The second method  is to run ASMOD without specifying a filename.  This will
  101. cause ASMOD to enter directory mode and display a list of all files with the
  102. extension .MOD.  To play any MOD file listed, simply highlight it  with  the
  103. arrow keys and press RETURN.  To change to another directory, highlight that
  104. directory's  name and press return.  To move back  one  directory, go to the
  105. '..' directory at the top of the list and press RETURN.  Both ESCAPE and the
  106. Alt-X key combination will exit to DOS from the directory mode.
  107.  
  108. While the MOD is playing you can move backwards or forwards in the song with
  109. PageUp and PageDown, which will move to the previous or next pattern.  Using
  110. the Up and Down  arrow keys will move backwards or forwards one  line in the
  111. current pattern.  Pressing ENTER will cycle through the  display modes while
  112. pressing the number of a channel will toggle the corresponding channel on or
  113. off.  Using the Left and Right arrow keys  will scroll  the pattern  display
  114. through  the available channels.  You can increase  and decrease  the master
  115. volume of the MOD  being played with the Plus and Minus keys  located on the
  116. keypad (the + and - above  the letter keys will not work this way).  To stop
  117. playing the MOD and  return to the diectory of files, press ESC.  Of  course
  118. all of these keys are listed in the bottom right  corner of the screen while
  119. a MOD is playing.
  120.  
  121.  
  122.  
  123. ABOUT AMOEBASOFT'S ULTRASOUND INTERFACE:
  124. ----------------------------------------
  125.  
  126. The code used to produced ASMOD was  written in Borland Pascal 7.0 and Turbo
  127. Assembler 3.2.  The  routines for loading  MOD files  were written in Pascal
  128. while the MOD playing routines are 100% assembler. Most of graphics routines
  129. used to create ASMOD.EXE (except for those  with  limited  applications) are
  130. part of the AmoebaSoft Video Toolkit.
  131.  
  132. The source for loading and playing MODs is included in the  SOURCE directory
  133. of this archive.  This source will also load and  play sound  effects  while 
  134. MODs are playing (just don't use the voices the MOD  player is using, always
  135. 1-4 and sometimes 5-8, depiding on how many channels are in the MOD).
  136.  
  137. The source is implemented with an IRQ handler  which you can  probably  just
  138. disable, since it only handles wave table IRQs and not ramp IRQs (which  can 
  139. be used to remove clicks at the beginning and end of samples).
  140.  
  141.  
  142.  
  143. NOTICE OF COPYRIGHT:
  144. --------------------
  145.  
  146. The program  described in this  document,  its  accompanying  files, and the
  147. source code which produced it are  Copyright (c) 1994  by Jonathan E. Wright
  148. and AmoebaSoft.  The  AmoebaSoft MOD  Player for  the  Gravis  UltraSound is
  149. FreeWare and the author offers it on an as-is, use at your  own risk  basis.
  150. Neither the author or  AmoebaSoft will be held  responsible for any  damages
  151. resulting from the use or modification of the files described herein.
  152.  
  153.  
  154. Legal  stuff aside, feel  free to  use this  code as you wish as long as you 
  155. give credit to  Nelno the Amoeba (me, the author, Jonathan E. Wright)  where 
  156. it's due.  If you make any significant improvements I'd  like to hear  about
  157. it.  See the .PAS files for information on contacting the author.
  158.  
  159.  
  160. Borland Pascal and Turbo Assembler are trademarks of Borland International.
  161. UltraSound and UltraSound MAX are trademarks of Advanced Gravis.
  162.  
  163.